I 


AD-A034  831  ARMY  MISSILE  RESEARCH  DEVELOPMENT  AND  ENGINEERING  LAB— ETC  F/6  9/2 

ANNOTATION  AND  CONTROL  SUBMOUTINE  SUBPROGRAMS  FOR  INTERACTIVE  G— ETC(U) 
NOV  76  L S ISOM 

UNCLASSIFIED  RG-77-1  NL 

^ i HH  lit  jmai 


AO 

A03A23I 


ADA034231 


ANNOTATION  AND  CONTROL  SUBROUTINE 
SUBPROGRAMS  FOR  INTERACTIVE 
GRAPHIC  DISPLAYS 


Larmon  S.  Isom 

Guidance  and  Control  Directorate 

US  Army  Missile  Research.  Development  and  Engineering  Laboratory 
US  Army  Missile  Command 
Redstone  Arsenal,  Alabama  35809 


Approved  for  public  release;  distribution  unlimited 


35609 


"?r’w*w 


DISPOSITION  INSTRUCTIONS 

DESTROY  THIS  REPORT  WHEN  IT  IS  NO  LONGER  NEEDED.  DO  NOT 
RETURN  IT  TO  THE  ORIGINATOR. 


DISCLAIMER 


THE  FINDINGS  IN  THIS  REPORT  ARE  NOT  TO  BE  CONSTRUED  AS  AN 
OFFICIAL  DEPARTMENT  OF  THE  ARMY  POSITION  UNLESS  SO  DESIG- 
NATED BY  OTHER  AUTHORIZED  DOCUMENTS. 


TRADE  NAMES 

USE  OF  TRAOE  NAMES  OR  MANUFACTURERS  IN  THIS  REPORT  DOES 
NOT  CONSTITUTE  AN  OFFICIAL  INDORSEMENT  OR  APPROVAL  OF 
THE  USE  OF  SUCH  COMMERCIAL  HARDWARE  OR  SOFTWARE. 


UNCLASSIFIED 

SECURITY  CLASSIFICATION  OF  THIS  PAGE  (N^ao  Data  Ef IfaradJ 


4.  TITLE  rand  Submit) 


REPORT  DOCUMENTATION  PAGE 


2.  GOVT  ACCESSION  NO 


ANNOTATION  AND ^ONTROL SUBROUTINE  SUBPROGRAMS  f 
*FOR  INTERACTIVE  GRAPHIC  DISPLAYS- S' * -* 


74 


ERFORMING  ORGANIZATION  NAME  AND  ADDRESS 

Commander 

US  Army  Missile  Command 
ATTN:  DRSMI-RG 

Redstone  Arsenal , Alabama  35809 


II.  CONTROLLING  OFFICE  NAME  AND  ADDRESS 

Commander 

US  Army  Missile  Command 
ATTN:  DRSMI-RPR 

Redstone  Arsenal,  Alabama  35809 


14.  MONITORING  AGENCY  NAME  4 ADDRESSrlt 


READ  INSTRUCTIONS 
BEFORE  COMPLETING  FORM 

IPIENT’S  CATALOG  NUMBER 


F REPUHI  4 PERIOD  COVERED- 

Technical  X?e£dtt , 


■blefummih  «RiidiEP 

RG-77-I 


NUMBER 


CONTRACT  OR  GRANT  ||UMB£R{» 

4 St*  1X363310DO^4  T 
AMCMS  Code  6333"l0. 0740012 


10.  PROGRAM  ELEMENT.  PROJECT,  TASK 
AREA  ft  WORK  UNIT  NUMBERS 


U.  HtPUHl  UJU! 


>76 


mmutM 

57 


15.  SECURITY  CLASS,  (of  thla  report;  . 

UNCLASSIFIED 


15a.  DECLASSIFICATION' DOWNGRADING 
SCHEDULE 


16.  DISTRIBUTION  STATEMENT  (of  thla  Report) 


Approved  for  public  release;  distribution  unlimited. 


17.  DISTRIBUTION  STATEMENT  (of  the  abetrect  entered  In  Stock  20,  It  different  from  Report) 


18.  SUPPLEMENTARY  NOTES 


19.  KEY  WORDS  (Continue  on  reveree  aide  If  neceaemry  and  Identify  by  block  number) 


Graphic  display  annotation 
Control  subroutines 
Interactive  graphic  displays 


2G.  aKTHACT  (Conltmue  an  reeerem  aide  ft  neceaemry  and  Identity  by  block  number) 

^ARecently,  numerous  digital  computer  simulation  programs  have  been 
developed  and/or  modified  to  incorporate  the  usage  of  the  interactive  computer 
graphics  terminal  system  into  their  resulting  output.  The  interactive  com- 
puter graphics  terminal  system  is  used  primarily  to  obtain  interactive  graphic 
displays  as  a portion  of  the  simulation  program  output  results.  These  dis- 
plays are  ideal  for  data  analysis,  data  reduction  and  retention,  and  for 

ABSTRACT  (Continued) 


DO  , 


FORM 

JAM  73 


1473 


EDITION  or  1 NOV  «»  IS  OBSOLETE 


UNCLASSIFIED 


SECURITY  CLASSIFICATION  OF  THIS  RAGE  (NNan  Data  Entararf) 


WO  469 


UNCLASSIFIED 


SECURITY  CLASSIFICATION  OF  THIS  PAGEflFhan  Dele  Entered) 


ABSTRACT  (Concluded) 

inclusion  within  presentations  and  technical  reports.  However,  these  displays 
require  annotations  such  that  they  can  be  identified  at  some  future  date. 
Certain  difficult  problems  are  associated  with  these  annotations  and  their 
placement  on  the  interactive  graphic  displays.  Hence,  this  technical  report  is 
an  attempt  to  describe  those  difficult  problems,  to  provide  a technique  for 
their  solution,  and  to  acquaint  the  interactive  computer  graphics^ terminal  sys- 
tem user  of  their  existence.  The  use  of  these  techniques  and  subroutines  shoulc 
make  the  interactive  computer  graphic  displays  more  easily  annotated  and  con- 
trolled than  they  have  been  in  the  past.  i 


UNCLASSIFIED 


SECURITY  CLASSIFICATION  OF  THIS  PAGEfHTion  D«l»  Entered) 


CONTENTS 


Page 


I.  INTRODUCTION 3 

II.  STATEMENT  OF  THE  PROBLEM 3 

III.  SOLUTION  OF  THE  PROBLEM 5 

IV.  THE  SUBROUTINE  SUBPROGRAMS 5 

V.  AN  APPLICATION  PROGRAM  AND  ITS  EXECUTION 19 

VI.  RESULTS,  CONCLUSIONS,  AND  RECOMMENDATIONS  23 

REFERENCES 31 

Appendix  A.  CHARACTER  CODE  CONVERSION 33 

Appendix  B.  STANDARD  OPERATING  PROCEDURE  FOR  TEKTRONIX  4002A 

GRAPHIC  COMPUTER  TERMINAL  TURN-ON 42 


'Appendix  C.  COMPARISON  OF  PROGRAMMING  METHODS  BY  EXAMPI£S.  ...  44 


1 


— 


= 


ACKNOWLEDGEMENT 

Acknowledgement  for  contributions  of  the  material  and  programming 
ideas  contained  in  this  technical  report  is  made  to  Ray  Conway,  Danny 
Jefferies,  and  John  Montgomery,  M&S  Computing,  Inc.;  Harold  L.  Pastrick, 
Charles  M.  Will,  Jr.,  and  Alexander  C.  Jolly,  Guidance  and  Control 
Directorate,  US  Army  Missile  Command;  the  personnel  of  Xerox  Data  Systems 
in  Huntsville;  the  personnel  of  Tektronix,  Inc.,  Huntsville  Office;  and 
Larry  Hazel  and  Ray  Vinson  of  Science  Applications,  Inc.  of  Huntsville, 
Alabama. 


I. 


INTRODUCTION 


Digital  computer  simulation  programs  are  continuously 
being  developed,  or  simplified  in  some  manner,  to  incorporate  the 
interactive  computer  graphics  terminal  system  to  obtain  graphic  dis- 
plays as  a portion  of  their  output  results.  These  displays  are  ideal 
for  data  analysis,  reduction  and  retention  purposes,  as  well  as  for 
inclusion  within  technical  reports  and  presentations.  However,  the  dis- 
plays require  annotations  and  labelings  such  that  they  can  be  identified 
at  some  future  date  for  reference  purposes.  Certain  difficult  problem 
areas  are  encountered  with  the  annotations  and  their  placement  on  the 
interactive  graphic  displays. 

This  technical  report,  therefore,  fully  documents  for  the  inter- 
active computer  graphics  terminal  system  user  some  of  the  more  difficult 
problem  areas,  techniques  and  methods  for  their  solution,  and  available 
subroutines  which  have  been  developed  for  interactive  graphic  display 
annotations  and  control.  A discussion  of  the  difficult  problems  of 
graphic  display  annotations  is  contained  in  Section  II  of  this  technical 
report.  Section  III  presents  a possible  technique  and  method  for  the 
solutions  to  the  problems.  Subroutine  subprograms,  which  have  been 
developed  and  placed  in  the  system  library,  for  graphic  display  annota- 
tions and  control  are  completely  documented  in  Section  IV  along  with 
examples  of  their  usage.  Section  V contains  an  application  program  which 
illustrates  the  utilization  of  the  graphic  display  annotation  and  control 
subroutines.  The  results,  conclusions,  and  recommendations  for  future 
study  and  application  are  contained  in  Section  VI. 

These  simulation  programs  and  subroutine  subprograms  are  presently 
being  used  on  the  interactive  computer  graphics  terminal  system  [1,2] 
located  in  the  Guidance  and  Control  Analysis  Simulation  Facility  of  the 
US  Army  Missile  Command's  Guidance  and  Control  Directorate  at  Redstone 
Arsenal,  Alabama.  This  simulation  facility  is  described  by  Jolly  et  al. 
[2].  Familiarity  with  digital  computer  system  operations  and  some  knowl- 
edge of  computer  programming  languages,  in  particular,  Fortran  IV  [3-10], 
has  been  assumed. 


II.  STATEMENT  OF  THE  PROBLEM 

This  section  contains  a discussion  of  some  of  the  more  diffi- 
cult problems  associated  with  the  annotating  and  controlling  of  the 
graphic  display  plots  by  the  interactive  computer  graphics  terminal 
system.  First  of  all,  the  input/output  (I/O)  done  by  the  terminal  con- 
trol system  (TCS)  Plot- 10  software  is  performed  by  two  subroutines, 
RD7611  for  input  and  WT7611  for  output,  respectively.  A description  of 
the  TCS  Plot-10  software  is  presented  in  reports  by  Tektronix,  Inc. 
[11,12].  Alternate  entry  points  for  the  two  subroutines  are  TINPUT  and 
TOUTPT  for  input  and  output,  respectively.  These  routines  are  system- 
dependent  and  must  be  provided  for  each  digital  computer  system. 
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Their  function  is  simply  to  input  and  output  American  Standard  Code  for 
Information  Interchange  (ASCII)  characters  (see  the  ASCII  Table  in 
Appendix  A).  The  data  are  transferred  to  and  from  the  Xerox  Sigma  5 
analog  coupler  driver  system  and  the  Tektronix  model  4002A  graphics  com- 
puter terminal  by  the  Xerox  model  7611  character-oriented  communications 
(COC)  controller  on  a character-by-character  basis;  for  output,  the 
character  is  contained  in  the  rightmost  byte  of  the  word  (i.e.,  byte  3). 

Secondly,  the  Extended  Binary-Coded-Decimal  Interchange  Code  (EBCDIC) 
is  used  by  the  Xerox  Sigma  5 analog  coupler  driver  simulation  facility, 
where  there  are  four  characters  or  bytes  per  word.  Therefore,  this  pre- 
sents a problem  of  conversion  from  EBCDIC  to  ASCII  for  graphic  display 
output  and  from  ASCII  to  EBCDIC  for  input.  Additionally,  only  certain 
characters  may  be  converted  from  EBCDIC  to  ASCII  and  vice-versa  by  the 
subroutines  and  function  subprograms  provided  in  the  COC  I/O,  control, 
and  utility  software  package.  The  particulars  pertaining  to  the  char- 
acter code  conversion  processes  can  be  found  in  Appendix  A. 

Finally,  the  characteristics  of,  and  strappable  options  available 
and  provided  with,  the  Tektronix  4002A  graphic  computer  terminal  effect 
the  annotations  and  control  of  the  graphic  display  output.  Some  of  the 
more  important  characteristics  and  options  are  as  follows: 

a)  39  lines  of  85  normal  size  or  italic  characters  in  the  main 
display  area.  One  line  of  84  characters  in  the  scratch  pad  area. 

b)  A 94  upper  and  lower  case  printing  character  (ASCII  code)  set. 

c)  The  optional  character  rotator  card  module,  which  is  installed 
in  the  drawer  unit  of  the  Tektronix  4002A,  provides  for  the  rotation  of 
displayed  characters  in  increments  of  90  deg  in  a clockwise  direction. 

d)  The  optional  horizontal  tab  feature  permits  insertion  and 
removal  of  horizontal  tab  positions  and  shifting  the, start  of  the  dis- 
played line  to  any  selected  tab  position. 

These  characteristics  and  options  have  the  following  affects  upon 
the  graphic  displays: 

a)  If  a line  of  output  characters  greater  than  the  85  allowed  is 
attempted,  the  output  is  jumbled  on  the  right  side  of  the  cathode  ray 
tube  (CRT)  display  screen  area. 

b)  If  more  than  the  39  allowed  number  of  lines  is  attempted,  the 
output  is  returned  to  the  "home"  position  (top  left  of  the  screen)  and 
the  output  is  continued  until  completion.  This  causes  overlapping  and 
overprinting  of  output  on  the  display  area. 

Appendix  B presents  a standard  operating  procedure  for  "turning-on" 
the  Tektronix  4002A  graphic  computer  terminal  each  morning.  This  proce- 
dure should  help  in  eliminating  the  difficulty  usually  encountered  in 
obtaining  the  first  graphical  displays  from  a digital  computer  program 
when  the  Tektronix  4002A  terminal  is  first  "powered-up." 


III. 


SOLUTION  OF  THE  PROBLEM 


The  obvious  solution  to  the  difficult  problem  areas  is  to 
develop  generalized  subroutine  subprograms  for  handling  the  annotations 
and  control  of  graphic  displays.  These  generalized  subroutines  have 
been  developed  and  placed  in  the  system  library  of  the  Xerox  Sigma  5 
analog  coupler  driver  simulation  system  facility.  If  any  of  the  sub- 
routines are  required  by  a user's  application  program,  the  subroutines 
are  loaded  at  load  time  by  the  overlay  loader  "OLOAD"  processor  of  the 
hybrid  real-time  batch  monitor  (HRBM)  operating  system.  These  subrou- 
tines have  been  written  in  the  extended  Fortran  IV  programming  language; 
however,  the  subroutines  are  compatible  for  usage  with  application  pro- 
grams written  in  the  Fortran  IV-H  programming  language  and/or  with  the 
macro-symbol  assemblier  language, provided  the  proper  linkage  is  estab- 
lished. Thus,  the  subroutines  are  easily  accessed  by  all  application 
users  of  the  interactive  computer  graphics  terminal  system. 

The  objective  of  this  report  is  to  describe  the  function  and  usage 
of  these  graphic  display  annotation  and  control  subroutines.  The  func- 
tional description  and  examples  for  usage  of  the  annotation  and  control 
subroutines  for  graphic  displays  are  contained  in  Section  IV,  Section  V 
presents  a typical  application  program  for  the  interactive  computer 
graphics  terminal  system  which  makes  use  of  the  graphic  display  annota- 
tion and  control  subroutines. 

For  comparison  purposes  only,  Appendix  C includes  four  programming 
examples  which  illustrates  the  various  methods  and  techniques  of  anno- 
tating and  controlling  the  interactive  graphic  display  plots. 


IV.  THE  SUBROUTINE  SUBPROGRAMS 

A.  Subroutine  CHARRD 

This  subroutine  enables  a user  to  interactively  control 
the  generation  and  hard  copy  output  of  CRT  displays.  Control  is  pro- 
vided by  characters  input  via  the  Tektronix  4002A  keyboard.  These  con- 
trol characters  enable  a user  to  obtain  a hard  copy  of  a graphic  display, 
to  redraw  the  current  display(s),  or  to  step  to  the  next  program  func- 
tion. The  control  characters  are  upper  case;  i.e.,  the  shift  lock  key 
of  the  CRT  keyboard  should  be  depressed  prior  to  selecting  a control 
character.  The  control  characters  and  their  functions  are  as  follows: 

C — Continue  to  the  next  program  function  (Fortran 

statement,  assumed)  following  the  call  to  subroutine 
CHARRD. 

D — Produce  a hard  copy  of  the  current  display  and  wait 
for  further  control  characters  to  be  input. 

R — Return  to  the  statement  label  specified  in  the 
calling  sequence. 
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All  other  characters  are  ignored;  however,  the  program  loops  (waits)  in 
this  subroutine  until  one  of  the  preceding  control  characters  is  input. 

Calling  Sequence: 

CALL  CHARRD  (&LAB ) 

where: 

The  calling  argument  (&LAB)  is  a statement  label  by  which  control 
is  transferred  upon  detection  of  the  R control  character. 

A normal  return  (to  the  statement  following  the  call  to  CHARRD)  is 
made  when  the  C control  character  is  detected. 


External  Subprograms  Required; 

BELL 

HDCOPY 

NDIG 

NSTCK 

RD7611 

Example  of  Usage: 

i : 

105  CONTINUE 

CALL  CHARRD  (&105) 


A listing  of  the  subroutine  CHARRD  is  shown  in  Figure  1. 
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Figure  1.  Listing  of  subroutine  CHARRD. 
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Input: 

The  execution  of  control  character  selected  for  input  from  the  Tektronix 
4002A  keyboard  as  subroutine  CHARRD  depends  upon  the  expected  output  results, 
output  results.  The  possible  inputs  have  already  been  described  pre- 
viously as:  'C*  — to  continue,  'D  * — to  make  a hardcopy,  and  'R'  — 

to  transfer  control  to  a Fortran  statement  label  of  the  calling  routine. 

Output: 

The  output  resulting  from  the  execution  of  subroutine  CHARRD  is 
dependent  upon  the  control  character  selected  as  input  from  the  4002A 
keyboard  (see  preceding  input). 

B.  Subroutine  HITLES 

Subroutine  HITLES  enables  a user  to  output  specified 
character  strings  for  graphic  plot  display  annotations.  The  user  must 
specify  position  and  character  orientation  for  the  character  strings, 
where  position  specifies  the  starting  position  for  the  first  character 
of  the  string  (specified  in  screen  coordinates) . Orientation  specifies 
that  the  character  strings  shall  be  output  either  as  a horizontal  string 
read  in  a left  to  right  manner,  or  a vertical  string  with  each  character 
rotated  90  deg  counterclockwise  such  that  the  character  string  is  read 
from  bottom  to  top,  i.e.,  assuming  the  bottom  of  the  CRT  display  is  the 
horizontal  axis. 

Calling  Sequence: 

CALL  HITLES  (LS,MH,MV,NC,HLAB) 
where: 

LS  — An  integer  variable  with  a value  of  1 or  2.  A value  of 
1 specifies  that  the  character  string  is  to  be  output 
horizontally  and  a value  of  2 specifies  that  the  character 
string  shall  be  output  vertically  with  the  90-deg  counter- 
clockwise rotation. 

MH  — An  integer  variable  that  specifies  the  screen  coordinates 
in  the  X-direction  from  the  lower  left  corner  of  the  CRT 
display  for  the  first  character  of  the  string. 

MV  — An  integer  variable  that  specifies  the  screen  coordinates 
in  the  Y-direction  from  the  lower  left  corner  of  the  CRT 
display  for  the  first  character  of  the  string. 

NC  — An  integer  variable  that  specifies  the  number  of  char- 
acters in  the  character  string  to  output. 
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HLAB 


An  array  containing  the  EBCDIC  character  string  to  be 
output  to  the  CRT  graphic  display.  The  calling  program 
(main/subroutine)  may  generate  this  string  by  filling  the 
array  with  Hollerith  constants  or  by  specifying  a Literal 
cons tant. 

External  Subprograms  Required: 

HLABEL 

MOVABS 

NASCII 

NSTCK 

RVTITL 

Example (s)  of  Usage: 

Example  No.  1.  Depleting  Hollerith  constant  data. 

• 

CALL  HITLES (1 , 150,75, 26, 26H  INDEPENDENT 
VARIABLE  LABEL) 

CALL  HITLES (2,60, 640 , 24 , 24H  DEPENDENT 
VARIABLE  LABEL) 


Example  No.  2.  Containing  Hollerith  and  Literal  constant  data. 

DIMENSION  LABH(7) ,LABV(6) 

DATA  LABH/' INDEPENDENT  VARIABLE  LABEL  '/ 

DATA  LABV / 24HDEPENDENT  VARIABLE  LABEL  / 

CALL  HITLES (1,150,75 ,2 6, LABH) 

CALL  HITLES (2, 60, 640, 24, LABV) 

Example  No.  3.  With  Literal  constant  data. 

CALL  HITLES (1,150, 75, 26, 'INDEPENDENT  VARIABLE  LABEL') 

CALL  HITLES (2, 60, 640, 24, 'DEPENDENT  VARIABLE  LABEL') 


A listing  of  the  subroutine  HITLES  is  shown  in  Figure  2. 
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Figure  2.  Listing  of  subroutine  HITLES. 


Output: 


The  output  to  the  CRT  display  resulting  from  subroutine  HITLES 
execution  is  dependent  upon  the  parameters  passed  within  its  calling 
sequence.  For  the  simple  examples  previously  given,  the  output  appear- 
ing on  the  CRT  display  screen  is  shown  in  Figure  3.*  Other  illustra- 
tions, which  contain  calls  to  subroutine  HITLES  and  its  resulting  out- 
put, are  shown  in  other  subsections  and  in  Section  V of  this  report. 


Input: 


None,  the  parameters  that  are  required  of  subroutine  HITLES  are 
passed  within  the  calling  statements. 


C.  Subroutine  RVTITL 


The  subroutine  RVTITL  outputs  to  the  CRT  display  character 
strings  specified  by  ASCII  integer  values  in  the  vertical  manner  with 
each  character  rotated  90  deg  counterclockwise.  Then,  the  character 
string  is  read  from  bottom  to  top.  The  user  must  specify  the  starting 
position  for  the  first  character  of  the  string  also,  as  well  as  the 
number  of  characters  to  be  output. 


*This  figure  was  output  from  program  example  number  4 in  Appendix  C. 
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Figure  3.  CRT  display  output  by  subroutine  HITUES 


Calling  Sequence: 


CALL  RVT1TL (MH ,MV , NC , LABRV ) 


where: 


MH 


MV 


NC 

LABRV 


An  integer  variable  that  specifies  the  screen  coordinate 
in  the  X-direction  from  the  lower  left  corner  of  the  CRT 
display  for  the  last  character  of  the  string. 

An  integer  variable  that  specifies  the  screen  coordinate 
in  the  Y-direction  from  the  lower  left  corner  of  the  CRT 
display  for  the  last  character  of  the  string. 

An  integer  variable  that  specifies  the  number  of  char- 
acters in  the  character  string  to  output. 

An  array  containing  the  ASCII  integer  values  of  the 
character  string  to  be  output  to  the  CRT  display. 


External  Subprograms  Required: 

ANMODE 

MOVABS 

NSTCK 

TOUTPT 

WT7611 


Example(s)  of  Usage: 


DIMENSION  LABRV (26) 

DATA  LABRV/ 73, 78, 68, 69,80,69,78,68,69,78,84,32, 
186,65,82,73,65,66,76,69,32,76,65,66,69,76/ 

• 

CALL  RVTITL(MH1 ,MV1 , NCI , LABRV (3) ) 

CALL  MOVABS (MH2, MV 2) 

CALL  HLABEL(26, LABRV) 


A listing  of  the  subroutine  RVTITL  is  shown  in  Figure  4. 
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i : 

3J333JTI  ■iZ  ?vT  I T|_  ( 'H# 

?: 

IVTE3ia  3VlM 

3: 

DMEVSI3')  3V_A3(VC) 

4: 

CA_L  'iDVABSf 

5: 

:a__  an'idde 

6: 

:a_L  WT76U  ( ?1  ) 

7: 

CA.L  a/T761  1 « 21  ) 

a: 

:a_L  wT7611(?1) 

9: 

D9  ID  J » 1*\ID 

10: 

< * ( VC  + 1 ) - J 

it: 

DA__  ^T761K3V_A3(<)  ) 

la: 

:a_l  T D J t 3 T ( a ) 

13: 

DA..  TDJT3TUD) 

14: 

2D 

r c ( NSTC< ( I ) .iz*  3)  3 

15: 

ID 

DD'JTI  VJE 

16: 

DA.L  /jT7611(?l) 

17: 

RET J3V 

is: 

END 

TD  ?D 


Figure  4.  Listing  of  subroutine  RVTITL. 


Input: 

None,  the  parameters  that  are  required  of  subroutine  RVTITL  are 
passed  by  the  calling  statement. 

Output: 

The  output  to  the  CRT  graphic. display  area  resulting  from  subroutine 
RVTITL  execution  is  dependent  upon  the  parameters  contained  within  its 
calling  statement.  For  the  simple  examples  previously  given,  the  output 
appearing  on  the  CRT  display  area  is  shown  as  in  Figure  5.  Heretofore, 
it  has  been  the  customary  practice  to  make  the  following  statement  calls: 


CALL  MOVABS (MH1 ,MV1) 

CALL  VLABEL(NCl ,LABRV (3) ) 
CALL  MOVABS (60,600) 

CALL  V LABEL ( 20, IDVL) 


to  obtain  the  CRT  display  as  shown  in  Figure  6 on  the  Tektronix  4002A 
graphic  computer  terminal  screen. 
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Figure  5.  CRT  display  output  by  subroutine  RVTITL 


Program  example  number  3 (Appendix  C)  was  used  in  obtaining  the 
output  results  contained  in  Figure  5.  This  is,  in  reality,  Figure  3 
redrawn  to  a different  scale.  Figure  6 is  the  output  resulting  from  the 
execution  of  program  example  number  2 statements  in  Appendix  C.  Notice 
that  this  is  the  customary  practice  for  obtaining  the  grid  lines  and 
tick  marks  on  the  graphical  display  plot.  However,  the  user  may  control 
these  options  by  including  various  calls  to  routines  to  handle  these 
functions  as  described  in  References  11  and  12  and  as  shown  in  the  pro- 
gram listings  of  Figure  10  and  Figure  C-2  in  Appendix  C.  These  subrou- 
tine calls  include  the  following: 


CALL  XFRM(2) 
CALL  YFRM(2) 
CALL  XMFRM(2) 
CALL  YMFRM(2) 


Also,  the  form  of  the  line,  as  well  as  the  size  and  shape  of  symbols, 
can  be  chosen  by  the  user  making  the  subroutine  calls: 

• 

CALL  LINE (14) 

CALL  SYMBL(4) 

CALL  SIZES (2.0) 


WARNING 

Serious  consequences  can  result  from  including  these  calls  within 
the  user  application  program.  This  can  be  demonstrated  by  including 
the  following  call  within  the  program  of  Figure  10, 

CALL  VBARST(4,46,25) 
instead  of  the  call 

CALL  VBARST(4,46,0) 

as  shown.  These  subroutine  calls  are  not  recommended  to  the  novice 
programmer  of  the  interactive  computer  graphics  terminal  system. 

D.  Subroutine  INTCRT 

Subroutine  INTCRT  performs  the  initialization  function 
for  the  interactive  computer  graphics  terminal  system.  Subroutine  INTCRT 
contains  call  statements  to  other  subprogram  routines  which  initiates 
the  hardware  components  by  resetting  the  Xerox  Model  7611  COC  controller 
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DEPENDENT  VERSUS  INDEPENDENT  DATA 


Figure  6.  Customary  form  of  CRT  display 


and  checking  that  it  is  switched  on.  External  interrupts  6 and  7 are 
centrally  connected  and  various  software  counters  are  initialized. 

Also,  calls  to  subroutines  are  performed  to  initialize  the  Tektronix 
Model  4002A  graphics  computer  terminal  hardware  and  the  Plot- 10  software 
system-.  The  one  call  to  subroutine  INTCRT  within  a main  program  or  a 
subprogram  routine  replaces  the  three  necessary  (required)  calling 
statements  to  subprograms  ST7611,  INITT,  and  BINITT.  A message  is  out- 
put to  the  CRT  display  screen  that  the  program  is  ready  and  that  a 'C' 
control  character  is  required  as  input  from  the  display  keyboard  to 
continue. 

Calling  Sequence: 

CALL  INTCRT (KAG 2) 

where: 

KAG2  — An  integer  parameter  (variable  or  value)  denoting 

that  the  advanced  graphing  II  software  package  is  to  be 
initialized. 

Example  of  Usage: 


CALL  INTCRT (1) 


Input: 

None. 

Output: 

The  output  resulting  to  the  CRT  display  screen  as  a consequence 
of  executing  subroutine  INTCRT  is  shown  in  Figure  7. 

External  Subroutine  Required: 

BINITT  ERASE  INITT 

CHARRD  HITLES  ST7611 

A listing  of  the  subroutine  INTCRT  is  shown  in  Figure  8. 


r 


IS  3J9R3jTHi  Imt:?T(<*32) 

25  3ME9SI99  WA3H(5) 

3S  3ATA  _A3h  / ' Ty°r  z T9  ;99TI\|J".  1 / 

»:  c * * 

5:  C J5E3  I9ITIA.IZATI99  Jr  I ; S T 5 ••• 

6 S C 3Y5  .A3H99  3.  1399  ••• 

75  C ***  1 9MCH  1376 

85  C 

9S  ID  CA__  ST78U 

10:  :a._  i ni tt i 1 ?o i 

US  I- <<A3?  . ME . 3)  3A_.  319111 

125  :a._  hit. "SM  . ?33#  433*  26.  ’A332A  I33T3  =993349  22A3Y,  1 ) 

131  :A._  HlT_rS(l,:>33,  373,  19,_A3H> 

1*5  :a._  3HA333K10) 

1 5 S :a__  2943E 

165  3ETJ3\I 

175  C • 

IAS  C •**  J3-3  "I9A.IZATI99  9-  I Z 3*  T Z *** 

19!  C t.M 

205  E9T3Y  C3Tr]9 

215  20  3A_.  2343“ 

225  CA__  HlT_rSM#233.433#  3% '4332a  I COT  3 =293349  :?9=_2T23» ' ) 

235  ;A._  hIT_23(  1»333*370#1=»_A3H) 

295  C A _ . :hA333(320) 

255  :a._  29A3E 

265  :A._  - I9ITT(0*790) 

275  :A__  HT 76 1 1 

28!  32TJ39 

295  290 


Figure  8.  Listing  of  subroutines  INTCRT  and  CRTFIN. 


E.  Subroutine  CRTFIN 


Subroutine  CRTFIN  performs  the  terminating  function  for 
the  interactive  computer  graphics  terminal  system.  A message  is  output 
to  the  CRT  display  screen  that  the  program  is  completed  and  requires  a 
' C ' input  from  the  keyboard  to  continue.  The  CRT  display  is  erased 
(cleared)  and  the  cursor  moved  to  the  home  (0,740)  position.  The  I/O 
activity  from/to  the  keyboard/display  through  the  Xerox  Model  7611  COC 
controller  is  terminated  and  the  centrally  connected  interrupts  (6  and  7) 
are  disconnected. 

Calling  Sequence: 

CALL  CRTFIN 

Parameter (s)  Entered; 

None . 
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Example  of  Usage: 


CALL  CRTFIN 


External  Subprograms  Required: 

CHARRD 

ERASE 

FINITT 

HITLES 

HT7611 

Output : 

The  output  to  the  CRT  display  screen  as  a consequence  of  subroutine 
CRTFIN  is  shown  in  Figure  9. 

The  calling  statement  to  subroutine  CRTFIN  in  the  main  program  or 
a subprogram  routine  replaces  the  necessary  (required)  three  calling 
statements  to  the  subroutines  HOME  or  MOVABS , FINITT,  and  HT7611.  Sub- 
routine CRTFIN  is  an  entry  point  in  subroutine  INTCRT. 

Input: 

None . 

A listing  of  the  subroutine  CRTFIN  is  shown  in  Figure  9. 


V.  AN  APPLICATION  PROGRAM  AND  ITS  EXECUTION 

This  section  presents  a typical  user  application  program  which 
uses  the  interactive  computer  graphics  terminal  system  for  a portion  of 
the  output  result.  This  program  illustrates  the  usage  of  the  graphic 
display  annotation  and  control  subroutines  that  have  been  developed  and 
discussed  in  Section  IV.  Most  of  the  examples  given  in  Section  IV  have 
been  used  within  the  main  program  contained  in  this  section.  Other 
examples  have  been  included, for  comparison  purposes  only,  to  compare 
these  techniques  and  methods  with  the  customary  practice  used  to  anno- 
tate and  control  graphic  displays  heretofore.  A listing  of  the  main 
program,  which  contains  the  calling  statements  to  the  annotation  and 
control  subroutine  subprograms,  is  shown  in  Figure  10. 
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21 
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23 

24 
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26 

27 

28 

29 
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31 

32 

33 

34 

35 

36 
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39 
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41 
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43 

44 
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46 

47 

48 

49 

50 

51 

52 

53 

54 
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57 


REAL*?  R«91»  Rvn92,  El 
0I9E9SI9N  Y\IJ9(15)»  XOAT  (15) 

DATA  YNJ9  / 15*0.0  / 

DATA  xOAT  / -3.53*-3.30*-2*53*-2.33*-1.50*-1.30*-0.53*3.0*3.50, 

1 1.00»1*53*2.00*2.50»  3.00*  3.50  / 

IX  • 1000 
= RINT  15 
°RINT  20 

09  10  I - 1*1000 

CAUL  RAMOJUX.IY,RN091> 

IF(I  .-E.  25)  3RIMT  25*1. IX, IY. RvjOHl 
CAuL  RAMOJt I X. 1 Y,RN092> 

£1  * 0S2RT(-2.333*3_93<RN39l) >.3C93<6.283185337?30*R'O42> 

I “ ( I ,LE.  25)  RR I NT  25.T. IX, IY.2vl092.il 
ER\J  « SNOLtEl) 

XLL I 9 * -3.25 
X JL I 9 « -2.75 
09  100  J * 2,14 

IFlER'J  • _T  • -3.25)  V M J9  ( 1 > * V M J -I  ( 1 ) * 1.0 
IP(£9N  , 3t • 3.25)  YM  J9 (15)  » YMJ9(15)  * 1.0 
IFtERS  • 3E . XLL  1 9 .AN3.  £RN  .LT.  XJlI9)  YSJ9(J)  • Y')J9(J)  + 1.0 
XLL I 9 • XLL I 9 + 0*5 
XJ.I9  ■ XJWI9  ♦ 0*5 
100  C9NT I VI JE 

10  continue 

3R I NT  15 

09  11  M • 1.15 

RRHT  30.M.X0AT(M)*YVJ9(9) 

11  C5MTINJE 
RRINT  15 

12  C9NT I 'J  JE 

C •*»  3U9T  THE  0*Ta  ... 

CA.L  INTCRTtl) 

CAUL  M°T3(15) 

CA  .L  ^ x xe  < 2 ) 

CA.L  XrR9 ( 2 ) 

CAUL  YFR9I2) 

CA.L  X9"R9(2) 

CA.L  X9-39(2) 

CA.L  Y9A3ST(4,46,0) 

CA.L  CH£C< (X0AT.YNJ9) 

CA.L  03=»LAY(X0AT,  Y9J9) 

CA.L  UlN£(14) 

CA.L  CdL9T(X0AT»YNJ9) 

CA.L  HlT.ESd.  300*30*24,  'RAS3E  9-  RAM099  MJ93ER3.') 

CA.L  HlTuE3(?»25. 630*25* 'rRE3JEMCY  5F  0 1 5T 3 1 3 JT 1 9S ' ) 

CAUL  -UTLESn, 230*733*38*  * HIST93RA9  9F  ?A>099  MJ93ER  3E^ERA  TI 9N ' ) 

CA.L  rRAHE 

CA.L  CHARR0(512) 

CA_^  CRTf  I vj 

CA.L  ?3*R'_3( ' 9Y  ' ) 

CA.L  EXIT 

15  -9R9AT  (HI,/./) 

20  -9R9AT(14X*1HI*5X*2HIX»10X*2HIY.8X.13HRAM099  9j*3ER) 

25  -9R9AT(10X,I5»I15>»I12*2015.5) 

30  c-9R9AT(10X.I3*3£i5.5) 

EMO 


Figure  10.  Listing  of  the  main  program. 


21 


r 


The  primary  purpose  of  this  program  is  to  generate  a series  of 
random  variables  (in  this  case,  1000)  and  to  plot  the  output  result  in 
the  form  of  a histogram  (see  Reference  13  for  a discussion  of  a histo- 
gram plot) . The  program  uses  a random  number  generated  with  a uniform 
distribution  by  a subroutine  to  obtain  a random  number  with  a Gaussian 
distribution  (zero-mean,  unity-variance)  using  the  Box-Muller  transfor- 
mation technique.  The  random  number  generator  is  subroutine  RANDU. 
Subroutine  RANDU  generates  random  numbers  with  a uniform  distribution 
in  the  closed  set  [0,1].  The  listing  of  the  subroutine  RANDU,  which  is 
based  on  the  recurrence  formula  or  multiplicative  method,  is  shown  in 
Figure  11. 


l : 
?: 
3: 
4 : 
s: 
a: 

7: 
h : 
9: 
in: 


B-PR  : J T I IT  ?A'OJ(  lY»  I Y,  *-_) 

y “ _ 

I Y * T Y * A n 5 3 3 
I r ( I Y ) 5 » A t A 

A Y - _ = I Y 

Yr  _ 3 Y-_«,4ASAMlI-9 
IX  = T* 

RFT  J-?\J 
END 


Figure  11.  Listing  of  subroutine  RANDU. 


All  programs  that  are  written  for  and  executed  on  the  Xerox  Sigma  5 
analog  coupler  driver  simulation  facility  are  under  control  of  the  HRBM 
operating  system.  The  necessary  job  control  commands  that  are  required 
by  the  HRBM  operating  system  are  shown  in  order  in  Figure  12.  The  main 

! JOB  RANDOM, NUMBER  TEST 
IFOR  TRAN  SI ,LS, G0,8C(25),NS 

******************************************************************* 
• • ** 


USER'S  APPLICATION  PROGRAM 
AND  oUBROUTINES 
GO  HERE. 


*************************************************************** 

! ASSIGN  (M:LO,LPA02),NOVFC 
IASSIGN  (M:LL,LPAO2),N0VrC 

I0L1AD  (TEMP, 450), (UDCR.1), (FORE, 2300), (LIB, USER .SYSTEM), (MAP) 

•.ROOT  (FILE,BT,GO,EOO),(FI LF ,0A,V3CA  fvB0,E 00) ,(F  I LE, 06, AG2F I LB0,E0D) 
: ASS  I GN  (F:6,LPA05) 

IFG 
IROV 
IF  IN 

Figure  12.  Listing  of  job  control  commands. 
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program  and  subroutine  RANDU  are  compiled  by  the  extended  Fortran  IV 
compiler,  loaded  by  the  system  processor  overlay  loader  "OLOAD"  from  the 
"GO"  file  onto  the  "OV"  file  along  with  the  required  TCS  Plot- 10  files, 
MOCAG2BO  and  AG2FILB0,  and  the  library  of  subroutine  subprograms.  Then, 
the  program  is  executed  in  the  foreground  area  of  computer  memory.  The 
resulting  outputs  from  the  execution  of  the  program  are  shown  in 
Figures  13  through  17.  Figures  13,  14,  and  15  are  the  outputs  to  the 
Tektronix  4002A  CRT  display  area.  The  output  listings  to  the  foreground 
line  printer  are  shown  in  Figures  16  and  17. 

An  alternate  form  of  the  graphic  display  for  the  same  basic  data 
may  be  obtained  by  making  a few  modifications  to  the  Fortran  statements 
shown  in  Figure  10.  These  modifications  are: 


a)  To  statements  40,  41,  and  42. 


40:  CALL  HBARST(4, 37 , 0) 

41:  CALL  CHECK(YNUM ,XDAT) 

42:  CALL  DSPLAY (YNUM,XDAT) 


b)  To  statements  44,  45,  and  46. 


44:  CALL  CPLOT (YNUM ,XDAT) 

45:  CALL  HITLES (1,300,30,25, 'FREQUENCY  OF 

DISTRIBUTION') 

46:  CALL  HITLES (2, 25, 600, 24, 'RANGE  OF  RANDOM 

NUMBERS. ') 


The  resulting  output  to  the  CRT  display  area  will  appear  as  shown  in 
Figure  18. 


VI.  RESULTS,  CONCLUSIONS,  AND  RECOMMENDATIONS 

This  section  presents  the  conclusions  and  comments  concerning 
the  annotation  and  control  subroutines  for  graphic  displays  previously 
discussed  in  Section  IV  of  this  report.  The  graphic  display  output 
resulting  from  the  execution  of  a typical  user's  application  program 
using  these  techniques  and  methods  has  already  been  described  in 
Section  V;  however,  their  use  and  application  extends  directly  to  the 
larger  graphic  display  utilization  of  application  programs  such  as  the 
CLGP,  PATRIOT  (SAM-D) , and  SIG-D. 
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Figure  13.  CRT  display  output  by  calling 
INTCRT  in  the  main  program. 


OGRft 


r 


i 


Figure  15.  The  CRT  display  resulting  from  a call 
to  subroutine  CRT FIN  in  the  main  program. 
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7 45  IP  41 9a 

• 14135  3 

33 

- . Vt 59 4 9 

44 

946511  4 5 4 

9 4 K S 1 1 4 9 4 

• 494793 

93 

P3 

1‘Hir.i  s i <,  i 

1 S <91  9 6 5 6 11 

.71 0053 

33 

- .950333 

93 

PI 

1 1 1 9 1 7 4 5 k.  4 

1 4 o 9 3 7 4 5 •,  4 

.941003 

99 

31 

1 o 111  1 ! 415 

1 4 3S 1 1 1 109 

.491343 

3 9 

-.011 003 

•4  4 

:i3 

3 1/44  11  9 -•P 

•’971441  9 >4 

• 4 9 7 6 3 

94 

;> 3 

1 P 7 7 14  > 4 4 3 

147713, >444 

.504733 

39 

-.on  743 

39 

4 9 

14  4 1 994  4*  9 

1 1 4 1 9 4 4 9 9 3 

.i37iH3 

34 

4 3 

17  14  19/444 

1 7 3 9 4 9 714° 

.740103 

3 3 

. 1 46543 

49 

:’4 

4 794 4 7 13 

v 7 1 4 1 7 ip 

,430543- 

91 

:>4 

P34/'.79-,6 

Ppo 79 79  >9 

. 1 39013 

39 

. 1 07703 

41 

•’5 

567466646 

W3951  i° 

. 3749/3 

9 4 

P5 

1 4 ->  4 4 9 1 4 44 

1494431044 

•577493 

33 

-.714453 

33 

Figure  16.  Line  printer  listing  of  the  random  numbers. 
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1 

-•350002 

01 

• 300002 

00 

p 

-•30 0002 

01 

• 1 DDD02 

01 

3 

- *250002 

01 

.110002 

02 

4 

- • 203002 

01 

•330002 

02 

5 

-•150002 

01 

• 730002 

02 

6 

-•100302 

01 

.125002 

03 

7 

- • 500302 

00 

.167002 

03 

8 

• 000002 

00 

•205002 

03 

9 

•500002 

00 

•165002 

03 

ID 

• 100002 

01 

• .125002 

03 

11 

•150302 

D1 

. 593D02 

02 

12 

‘200302 

01 

• 230002 

02 

13 

•250302 

01 

.120002 

02 

14 

•303002 

01 

.100002 

01 

15 

• 3 5 ODD* 

01 

OOOO*^ 

00 

Figure  17.  Line  printer  listing  of  the 
random  number  histogram  data. 


As  can  be  observed  from  the  application  program  presented  in 
Section  V,  it  can  be  concluded  that  graphic  displays  may  be  annotated 
and  controlled  more  easily  by  the  techniques  and  methods-  presented  in 
this  report  than  has  been  possible  within  past  programs.  Additionally, 
these  methods  and  techniques  produce  no  affects  upon  the  output 
resulting  from  the  execution  of  user's  application  programs  written 
in  the  past  that  utilizes  the  interactive  computer  graphics  terminal 
system.  However,  the  use  of  these  subroutines  would  lessen  the  cost 
and  shorten  the  time  frame  for  obtaining  properly  annotated  graphic 
displays.  It  is  recommended  that  these  programming  practices  and  pro- 
cedures be  adopted  in  future  user  application  programs  which  involve 
the  interactive  compute  graphics  terminal  system. 
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Appendix  A:  CHARACTER  CODE  CONVERSION 

This  appendix  addresses  the  problem  and  the  process  of  character 
code  conversion  between  the  ASCII  character  codes  for  the  Tektronix 
4002A  graphic  computer  terminal  and  the  EBCDIC  for  the  character  codes 
of  the  Xerox  Sigma  5 digital  computer.  The  primary  purpose  of  this 
appendix  is  to  show  that  conversion  from  ASCII  to  EBCDIC  can  be  per- 
formed, and  vice-versa,  as  well  as  to  determine  what  character  codes  in 
ASCII/EBCDIC  are  converted  to  what  EBCDIC/ASCII  character  codes  by  the 
COC  software  package. 

4 

Table  A-l  presents  the  possible  128  ASCII  character  codes  and  their 
functions  for  the  Tektronix  4002A  graphic  computer  terminal  in  the 
various  formats;  such  as  binary,  decimal  integers,  and  graphical  alpha- 
numerics.  Figure  A-l  depicts  the  output  to  the  CRT  display  area  result- 
ing from  these  128  character  codes  being  transmitted  to  the  display  area 
by  the  Sigma  5 digital  computer.  The  line  printer  listing  of  these  same 
128  character  codes  upon  being  converted  from  ASCII  to  EBCDIC  are  con- 
tained in  Table  A-2.  These  outputs  and  code  conversions  were  accom- 
plished by  executing  the  main  program  as  shown  in  the  listing  of 
Figure  A-2  with  the  aid  of  the  Tektronix  Plot-10  and  the  COC  software 
packages.  It  should  be  readily  observed  that  a majority  of  the  ASCII 
character  codes  are  converted  to  the  EBCDIC  code  for  a blank  space 
(40^  or  64^)  by  the  COC  software  package;  also,  that  the  results 

returned  from  the  Fortran  function  call  to  "NEBCD"  is  contained  in  the 
last  byte  (rightmost)  of  the  word. 


In  a similiar  fashion,  the  256  possible  EBCDIC  character  codes  were 
converted  to  ASCII  character  codes  by  the  COC  software  package,  trans- 
mitted through  the  Xerox  Model  7611  COC  device  by  the  Sigma  5 digital 
computer,  to  the  Tektronix  4002A  CRT  display  screen.  The  resulting 
output  to  the  CRT  display  area  is  shown  in  Figure  A- 3,  while  Table  A-3 
presents  the  line  printer  output  listing  for  the  program  execution. 
Again,  it  is  observable  that  a majority  of  the  EBCDIC  character  codes 
are  converted  by  the  COC  software  package  to  the  ASCII  character  code 
of  00^,  which  is  a "NUL"  character.  The  main  program  to  accomplish 

this  EBCDIC  to  ASCII  conversion  is  depicted  as  the  listing  shown  in 
Figure  A-4.  Observe  that  not  all  alphanumeric  symbols  displayed  on  the 
CRT  display  area  are  printable  on  the  line  printer. 


TABLE  A-l.  4002A  GRAPHIC  COMPUTER  TERMINAL 


ASCII  CODE  FUNCTIONS 


CONTROL 


<1UL  0 Dll  16 


SGH  I DCI  IT 

HOME 


SIX  2 DCS 


EOT  4 DC4  70 

REFRESH  ' 


ENO  3 NAK  21 

ROTATE 


SYN  22 


BEL  7 ITB  23 

BELL  HARDCOPY 


Si  8 CAN  34 

BACKSPACE  ERASE 


nT  9 EM  2S 

DOUBLE 

TAB  SIZE 


IE  10  SUB  26 

L \EFEEO 


II  ISC  27 


FF  12  FS  28 


MIOH  ORDER 
XtT 


C7.  13 

GS  29 

RETURN 

VECTOR 

O 14 

1 .’L.C 


SP  ” 

0 4‘ 

CLEAR  TAB  * 

1 “ 

1 49 

BET  TAB  • 

..  94 

2 “ 

# ” 

3 51 

$ “ 

4 " 

% 37 

5 

IS 

34 

6 

, 39 

S3 

7 

< ** 

36 

8 

i 41 

9 57 

42 

* 

. *• 
s 

+ ** 

39 

s 

i 

44 

9 

< “ 

43 

_ 61 

4* 

• 

> - 

LOW  ORDER 
X 


a p 


B 


C 67 

CLEAR  C 

SCRATCH  • 


s 


RESET 

COMPOSE 


• PRECEOEO  BY  ESC 

1 PRECEOEO  BY  SELECTION  OF  COMPOSE  MOOE 

2 TTY  TRANSMIT  ONLY 


71  87 

G W 


74  90 

z 


73  91 

c 


76  92 


M 77  i 93 

CLEAR  TABS  J 


78  94 

N A 


7Vl  93 


LOW  ORDER 
Y 


96  112 

P 


97  113 

a q 


991  113 


100  116 

d t 


101  H7 


102  ITS 

f V 


103  119 

g w 


104  120 

h x 


103  121 

* y 


106  122 

j * 


107  123 

k { 


10S  124 

I I 


109  j.  123 

^ ALT  MOOE  2 


110  126 

n ~ 


»1'  RUB  127 


GRAPHIC 

INPUT 


1 

1 


,1 


• "A 

h 


A 

< 

* 

II 

r— t 

r-^N 

V/ 

/ 

— 

i__i 

♦ • 

rsi 

N 

CD 

>- 

X 

GO 

X 

X 

I\ 

3 

z 

CO 

z> 

> 

lO 

ZD 

3 

'tf- 

♦— 

-*■» 

ID 

cn 

in 

OJ 

O' 

tH 

■3 

tr 

Qt> 

0- 

a, 

\ 

o 

o 

♦ 

z 

c 

1 

2= 

£ 

* 

_J 

rH 

+ 

-* 

>r> 

•o 

— • 

M 

•H 

X 

x: 

% 

C5 

aD 

Ll. 

<M 

* 

Ld 

u 

(ft 

Q 

TJ 

* 

O 

U 

r 

00 

X2 

— 

<c 

a 

e> 

✓ 

35 


a i 


CL 

CO 


c3 

o 


4J 

3 

CL 

4J 

3 

O 

CO 

a> 

T3 

o 

o 

u 

<1) 

4J 

o 

CTJ 

M 

cd 
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u 

co 
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a> 

3 
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CA_L  I'JTc^Tfl  ) 


CA.L 

C A_L  ^3VA55( 3#733) 
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23 

11 

CA.L 
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1? 
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33-31  Z 
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* -31 31 C 
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39  13 
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17 
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19 
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20 
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21 

I-(  I 

• E3.  3?)  32INT  23 

2? 

If  < I 
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• E3.  1 5 8 ) 1 NT  23 

28 

.313 

* -313  ♦ INC 

29 

ID 
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3? 
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n 

35 

CA.L 
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CA.L 

EXIT 

37 

1 5 
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20 
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39 

EN3 

Figure  A- 2. 

Listing  of  main  program  for  ASCII/EBCDIC 

character  code  conversion. 
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Figure  A-3.  Results  of  EBCDIC  character  codes  converted 
to  ASCII  and  output  to  the  CRT  display  area. 
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Legend: 

© Decimal  integer  © EBCDIC  hexidecimal  code  © ASCII  hexidecimal  code  © Line  printer/CRT  display 

alphanumeric  symbol 


1 

OAT  A 

_ 0 1 3 1 Z / 87  0330330''  / 

? 

OATA 

1\Z  / **  7 39393031  / 

3 

5 

Z9  . T I \J  J2 

4 

r* 

w 

5 

ZA 

I NTZ3T  ( U 

6 

r* 

w 

7 

ZA.L 

23452 

8 

:a_. 

^9VA3",  ( 0,  790  ) 

9 

:a_l 

M-W_I  M 

10 

C A _L 

AM910Z 

11 

ZA.L 

05-317 

IP 

-013 

II 

u 

~-4 

< > 

13 

33INT 

33 

14 

r* 

C- 

15 

03  10 

II 

►— » 

\J 

J1 

J' 

16 

= NA3ZII (-919,4) 

17 

<013 

S _ 0 I J 

18 

I - ( L : 

-12  _010iz)  <OT3  = 6 

19 

32I\'T 

15, LOI It -013#  _C-I3»  <01 3 

20 

Z A _ 

* T 7 6 1 1 < -0391 

21 

Ir<  I 

.20.  3?)  Z A _L  M'WuT'J 

2? 

I-  ( I 

.20.  32)  J9IMT  20 

23 

I*  ( I 

.2  0.  64)  ZAlL  M 2 W _ 7 VJ 

24 

I - ( I 

.20.  64)  T NT  23 

25 

I - < 1 

.20.  96)  ZAlL  <>2^-TV 

26 

1*  ( I 

.20.  96)  32INT  23 

27 

I =•  f I 

.20.  1?S>  ZAL-  N 2 ■ < _ I N 

28 

I =•  ( I 

.20.  1 ?«  ) =?INT  20 

29 

I-(  I 

.20.  160)  ZAl NZn'.TN 

30 

Ir<  I 

.20-.  1 60)  3 3 1 vi T 20 

31 

I3(  I 

.20.  199)  ZAL.  N2  '_J  'i 

3? 

Ir<  I 

.20.  1?»)  3?I)T  ?9 

33 

I “ ( I 

.20.  ZaL_  N2/.IN 

34 

l3<  I 

.20.  2 3 <+ ) =»^I  vT  20 

35 

I=-(  I 

.20.  ?5s)  Z aL_  N2  _ T n 

36 

1“  ( I 

.20.  256)  a^INT  2 0 

37 

-015 

* -013  ♦ ! NZ 

38 

10 

Z9mTIM.J£ 

39 

za.l 

M98SI7 

40 

Z a _ _ 

Z^A^Of  V5) 

41 

4? 

CA__ 

Z 5 T “ I N 

4 3 

w 

44 

ZA 

r o * 7 - 5 ( * 9 'J  ' ) 

45 

ZA  __ 

2 X I T 

46 

15 

"331AT(10X»I5# ?X#2?/3X/7?,A4) 

47 

20 

“93  ^ A T ( 1 HI ,/./,/ 1 

48 

2M0 

Figure  A-4.  Listing  of  the  main  program  for  EBCDIC/ASCII 
character  code  conversion. 
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Appendix  B.  STANDARD  OPERATING  PROCEDURE  FOR  TEKTRONIX 
4002A  GRAPHIC  COMPUTER  TERMINAL  TURN-ON 


When  first  "powered-up"  each  day,  the  Tektronix  4002A  graphic  com- 
puter terminal  user  usually  has  difficulty  in  obtaining  the  first  graph- 
ical display  from  a Xerox  Sigma  5 digital  computer  program.  To  obtain 
this  graphical  display,  the  program  has  to  be  reexecuted,  which  is  time 
consuming.  To  eliminate  this  difficulty  in  the  future,  it  is  suggested 
that  the  following  standard  operating  procedure  be  adopted  for  "Turning- 
On"  the  Tektronix  4002A  graphic  computer  terminal  for  the  first  time 
each  day. 

1)  Turn  the  power  switch  ON,  vertical  to  horizontal  — clockwise. 
Allow  to  "Warm-Up"  a few  minutes. 

2)  Set  the  "On  Line-Local"  rocker  switch  to  Local . 

3)  Set  the  "Direct-Scratch  Pad"  rocker  switch  to  Scratch  Pad. 

4)  Press  the  following  keys: 

a)  Home. 

b)  Erase. 

c)  Space  bar,  to  enter  the  scratch  pad  mode  of  operation. 

d)  Full,  to  clear  the  scratch  pad  area. 

e)  Enter  information  into  the  scratch  pad  area  by  pressing 
the  desired  keyboard  keys. 

f)  Send,  to  send  the  information  to  the  CRT  (Cathrode  Ray 
Tube)  screen. 

g)  To  enter  a full  CRT  screen  of  information,  enter  Line  Feed 
and  Return  while  in  the  scratch  pad  mode  of  operation;  press  and  hold 
down  the  Space  bar  and  Send  keys  while  repeatedly  pressing  the  Repeat 
key. 

5)  When  Item  4 has  been  completed,  press  the  following  keys: 

a)  Space  bar,  to  enter  scratch  pad  mode. 

b)  Full . to  clear  the  scratch  pad  area. 

c)  Home . to  exit  the  scratch  pad  mode. 

d)  Erase,  to  clear  the  CRT  screen. 

e)  Set  the  "On  Line-Local"  rocker  switch  to  On  Line. 

f)  Set  the  "Direct- Scratch  Pad"  rocker  switch  to  Direct . 

6)  The  Tektronix  4002A  graphic  computer  terminal  system  is  now 
ready  for  operation  by  an  application  program  from  the  Xerox  Sigma  5 
digital  computer. 
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7)  If  hard  copies  are  to  be  obtained,  turn-on  the  Tektronix  4601 
Hard  Copier  Unit. 

8)  When  the  program  has  ’been  completed,  the  CRT  screen  should  be 
erased  and  the  cursor  beam  returned  to  the  home  position. 
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Appendix  C.  COMPARISON  OF  PROGRAMMING  METHODS  BY  EXAMPLES 

This  appendix  compares  the  programming  methods  for  annotating  and 
controlling  interactive  graphic  display  plots.  The  main  application 
program  is  contained  in  Figure  C-l.  This  program  contains  essentially 
four  identical  graphic  displays.  Each  display  is  annotated  by  a oiffer- 
ent  technique  and  is  produced  by  subroutine  PLOTSD,  which  is  shown  in 
Figure  C-2.  The  first  programming  example  of  the  main  program  produces 
Figure  03,  which  is  the  graphic  display  output  produced  by  subroutine 
PLOTSD.  It  contains  no  annotations  except  for  those  output  by  the  sub- 
routine DATER. 

Programming  example  number  2 of  the  main  program  is  the  Fortran 
statement  numbers  40  through  56  of  Figure  C-l.  This  example  is  the 
customary  manner  in  which  interactive  graphic  displays  have  been  anno- 
tated in  the  past.  Observe  that  a large  number  of  Fortran  dimension 
and  data  statements  are  required  as  well  as  calls  to  subroutine  MOVABS 
in  order  to  annotate  the  graphic  display  by  this  example.  Also,  observe 
that  the  vertical  annotations  have  not  been  rotated  as  they  are  in  other 
examples.  Figure  C-4  shows  the  CRT  display  output  from  program  example 
number  2. 

Program  example  number  3,  Fortran  statements  58  through  72  of  the 
main  program,  is  almost  identical  to  programming  example  number  2.  How- 
ever, it  calls  the  subroutine  RVTITL  to  rotate  and  place  the  vertical 
annotations.  The  resulting  output  to  the  CRT  display  area  is  contained 
in  Figure  C-5. 

The  program  example  number  4 of  the  main  program  is  Fortran  state- 
ments 74  through  83  of  Figure  C-l.  This  example  uses  the  calls  to  sub- 
routine HITLES  to  place  the  annotations  on  the  interactive  graphic  dis- 
play plots.  This  method  is  recommended  in  the  future  for  all  programs 
which  contain  outputs  to  the  CRT  display  area,  because  no  dimension  and 
data  statements  are  required  in  the  main  program.  Figure  C-6  is  the  out- 
put to  the  CRT  display  screen  area  resulting  from  the  execution  of  pro- 
gram example  number  4. 

Although  these  four  programming  examples  have  been  lumped  together 
within  one  large  application  main  program,  they  do  represent  the  various 
techniques  of  graphic  display  annotations  and  the  amount  of  programming 
effort  involved. 

1)  No  annotations,  no  effort  involved  by  example  1. 

2)  Annotations  by  example  4,  some  effort  involved,  but  not  as 
much  as  required  by  examples  2 and  3. 

3)  Annotations  by  examples  2 and  3,  the  maximum  amount  of  effort 
involved. 
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Notice  that  by  removing  the  Fortran  statements  for  each  programming 
example  along  with  the  required  dimension  and  data  statements,  four 
separate  and  distinct  programs  could  be  developed  from  these  four 
examples . 

Finally,  Figure  C-7  shows  a listing  of  the  subroutine  DATER.  The 
CRT  display  output  as  a result  of  a call  to  subroutine  DATER  is  con- 
tained in  Figure  C-8. 

Additionally,  the  calls  to  subroutine  CHARRD  in  the  main  program 
permit  the  user/operator  to  perform  adjustments  on  the  Tektronix  4002A 
graphic  computer  terminal  and/or  the  4601  hard  copier  unit.  The  contrast 
control  on  the  4601  hard  copier  unit  may  be  set  too  low  (light),  produc- 
ing a copy  as  shown  in  Figure  C-9,  or  set  too  high  (dark),  producing  a 
copy  as  shown  in  Figure  C-10.  Likewise,  the  intensity  control  on  the 
Tektronix  4002A  graphic  computer  terminal  may  be  set  too  low  or  too 
high,  producing  similiar  resulting  copies  as  shown  in  Figures  C-9  or 
C-10  also.  Further,  the  supply  of  4601  hard  copy  paper  can  be  depleted 
while  an  application  program  is  executing.  Subroutine  CHARRD  allows 
the  program  to  continue  without  hard  copies  being  made,  and/or  the  paper 
supply  replenished  in  the  4601  hard  copier  unit. 
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57: 
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62: 


A DE49NST24TI9N  P29S2A4  P92  LA3ELIN3  394»Hl: 
3T:  L4249N  S.  1594 
1 9CT93E5  1976 


DISPLAVS. 


DIMENSION  ST  4TE4ENTS 

DI4ENSI5N  I 33T ( 1 4 ) » I C3TST  < 1 4 ) # U43V<6>.  .484(7) 

31  MENSl  9N  I V. ( 1 A ) , IDVL<=0>,  I-»_  <5S>,  _A32Vf26) 

3ATA  STATEMENTS 

3ATA  _A38V  / 73.78*68. 69. 80,59, 78. 65,59.78.54.32.55,65.82.73,65* 
166*76.69.32.76.65*66.69.76  / 

DATA  I DV_  / 86.69.76.79.67.73.94,99.32.49,73.69.69.84.47.83.69,67* 
1 46.41  / 

DATA  IV.  / 54.73.77.89,32,43,93.69.97.79,78.68,93.41  / 

DATA  <1*1/  33  /,  MV1  / 64D  /,  MCI  ✓ 24  /.  MV2.442/  53,  333  / 

DATA  1.A3H  / 'INDEPENDENT  VA2I43.S  U43EL  • / 

DATA  _A3V  / 244DEPENDENT  VA2I43.E  U43E.  / 

DATA  I 3DT  / '3243HICAU  DIS=_AT  9-  DEPENDENT  VE23JS  INDEPENDENT  OAT 
/ 

/»  I C3T3T (2)  / 

/,  I C3TST ( 5 > / 

/,  I C3TST ( 8 > / 


1A.  • 

DATA  IC3TST ( 1 ) / 44EX44 
I C3TST ( 4 ) / 'ANNS' 
I C3TST ( 7 ) / 4HND  C 
I C3TST (ID)/  'SA3E' 


1 /. 
2 /, 
3 /. 


44'  /, I C3TST  <131/  44=4!C 


'=LES'  /.1 C3TST  ( 3L)  / 44  97 
44TATI  /,  I C3T3T ( 6 ) / '9N  A' 
' 9 NT 8 ' /,  I C3T3T ( 9 ) /449L  J 
/.  IC3TSTU1J/  44  T92  /,  I C3T5T (12)  / ' 3R 
/,  I C3TST  < 1 4 J / »3.  ' / 


CA.L  ST7611 
CAUL  I NI TT ( 1 23) 
CAUL  8 1 N I TT 


ICGT3  INITIAWIZATI9N  STATEMENTS 


D9  13  I - 1.55 

IHL(I)  • NASEII ( IC3TST.I ) 

13  C9NTINJE 

=293244  EXAMa.r  NJ43E2  1. 
CALL  =L9TSD(36»1.0> 

CAUL  C4A28D (513) 

=893244  EXA43.E  NJ43E2  =. 

99  C9NTI NJE 

CAUL  =L9TSD (36.1.75) 

CALL  49VA35(441,4V1) 

CAUL  VLA3EL(NC1»LA32V(3) ) 

CAuL  49VA3S ( 63. 630 ) 

CAUL  V.A3EU(20, IDVu) 

CALL  49VA3S( 203. 10) 

CALL  4LA3Ei.  ( 55.  I 4L  ) 

CAuL  49VA3S ( 363.30 ) 

CAUL  4LA3EL(26,LA82V> 

CA.L  49VA5S ( 433. 53 ) 

CAUL  4LA3Eu(14,IVL> 

CA.L  49VA3S(=33»723) 

D9  23  J - 1.55 

CAUL  4LA3Eu(l.NASCII (I3DT.J)) 

20  C9NT I NJE 

CALL  CHA28D ( 599 ) 

= 2932 A 4 EXA43.E  NJ43E9  3. 

98  C9NTINJE 

CA.L  =L8TSD (36,1.25) 

CAUL  2VTITL(441.4V1,NC1.LA38V(3) ) 

CALL  2VTlTu(63»600,23»IDVL) 

CAUL  49VA3S ( 200. 1 0 ) 


Figure  C-l.  Listing  of  application  main  program. 
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S3*  HLA3E.(55.HL> 

6*:  CA__  *i9v  A 33  { 36  0/  30 ) 

655  C»_L  -ILA3f.06..A93V) 

66!  CA.L  >19VA33<439#50) 

67!  :*.L  H-A3E_( 14, I VL ) 

6S:  :*.L  49\/A93(?03#723> 

63:  39  3.1  J « 1 1 55 

73:  H_A3E_<i,\IASCII  (I39T#J)  ) 

7i:  39  C9MTIMJE 

7?:  CA.L  3"tA393 ( 594 ) 

73:  Z = 3939A>i  EXA93.E  M R 4. 

74:  97  C9MTI>JJE 

75:  :a__  3'_9TS3  (36>  1 >5  ) 

76!  CA.l  -IIT_E3(1#963»30#36»_A3H) 

77:  :a._  *-(IT.E3(?»:n.64D,24».A3\/) 

7s:  CA_.  HlT_ESM,433/53#14>  • T I *i£  tSiC9'03)  • ) 

79!  -IIT.ESO.  6'1»631»2','»  'v7i_5CITr  < FEET/SEC. )' > 

so:  ;a_L  HIT_E3<1#?93*7?0*55. '39asHICA_  3IS3.Ay  9f  3E«>E'OE'JT  VE3SJ3  I» 

9i:  HE^'OE'JT  3A T A • • ) 

9?:  CA__  -(IT_ES(t»?03»13*55*tC3TST) 

33:  :a_'_  -ma390(«:97) 

34 : c 

35!  CA_L  :-IA93D(  519) 

36!  C IC3T3  -I9ALI7ATI99  5T ATE^E'ITS 

57:  :a._  ?9A3r 

58:  r A __  - I'JITT(3*76'1) 

39:  CA._  HT7611 

9o:  C 

91 : CA._  F3*3_3 ( « 9v  • ) 

9?:  :a_l  exit 

93:  ESI 


Figure  C-l.  (Concluded). 
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1!  3J333JTIMC  3U9TS3('J5(»,S- ) 


? 

3I3EMSI33  X ( 1 01  ) , S9X(133)#C9X(133) 

3 

3I3E\iSI03  C9x9 ( 1 30 ) # S9X3(133> 

4 

3I3ENSI9M  I-LI36) 

5 

3ATA  13.  / 32*42, 84*72*69*32. 7l*»?#65. 33. 72# 73#67#65#76#32. 68*73*. 

6 

1 83*  83#  76*65*39. 32# 71 » 79* 69# 93# 32* 7?# 69, 8?* 69* 46* 4?, 3?  / 

7 

3ATA  133  / 3 / 

S 

A3 1 'J  « *13333.3 

9 

SMI'J  « A3I»J 

10 

A3AX  « -13033.3 

11 

33AX  • A 3 4 X 

12 

I =■  { 133  .ME.  3)  39  T9  11 

13 

133  » 1 

14 

X C 1 ) . 3.3 

15 

39  13  I • 1*39= 

16 

09x3 ( I ) » C9S ( X ( I > ) 

17 

59X3 ( I ) • 51  Ml X< I ) ) 

18 

X(I*1 ) « X ( I ) * 3*2617994 

19 

X(I>  » X( 1)457.29577951 

20 

13  C9MT13JE 

21 

11  09MTI3JE 

2? 

39  12  I * 1.M43 

23 

C9X ( I ) » Sr»C9x3(I) 

24 

S9X ( I ) ■ 3-459X3 ( I ) 

25 

1?  C9MT I M JE 

26 

CA.L  E9AS? 

27 

X OA'.L  r9A>ir 

28 

CA.L  3=T3(399) 

29 

X CA.L  XP33(3) 

30 

X CA.L  V"23(6> 

31 

X CA.L  X3-93(3) 

32 

X CA.L  Y3"93(3) 

33 

CA.L  LIMSO) 

34 

CA.L  S Y 3 3 ( 3 ) 

35 

CA.L  3N3X(x.a3I\I,A3AX) 

36 

CA.L  '*'J3x<r?X/33IN,33AX> 

37 

CA.L  333x(59x,33IN,33AX) 

38 

CA.L  3-13X1 A3IM.A3AX) 

39 

CA.L  3-1  3 y < 331  'J,  93AX) 

40 

CA.L  C3EC< ( X, C9X  > 

41 

CA.L  C3EC< ( X, 59X ) 

42 

CA.L  333_AY ( x» 59x > 

43 

39  15  1 . 1 # 'JO3 

44 

CA.L  39V5A ( X ( I ) ,C9X(  1 ) ) 

43 

CA.L  AN343E 

46 

CA.L  -l-A3E.(l*  H_(  I ) ) 

47 

16  I r ( MSTCX ( I ) .52.  3)  39  T9  16 

48 

15  C93T1MJE 

49 

CA.L  OATr^ 

50 

9ETJ93 

51 

E33 

Figure  02.  Listing  of  subroutine  PLOTSD. 
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TIME  ( SECONDS  > 
INDEPENDENT  UARIABLE  LABEL 


GRAPHICAL  DISPLAY  OF  DEPENDENT  UERSUS  INDEPENDENT  DATA 


tiguie  C-5.  CRT  dispiay  output  produced  by  program  example  number 


V'V* 


Figure  C-6.  CRT  display  output  produced  by  program  example  number 
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1!  3J3^3JTIMC  dat2* 

?:  DME'JSISM  M A ME  f ?0 ) , I DAT  ( 22 ) 

3!  DATA  same  / 6R»??«65»87.78#3p»6S.S9»53»3?#76,46.32#*3*a6#32#  73» 

4S  1 S3*  79»  77  / 

55  DATA  I DAT  / AR»69»34»69»58»32»56»??»79*67*R4#79*66»69»®2/32*49# 

6:  1 57/55/ 54/ 32*  3?  / 

7:  DATA  vj;\|,  SC 3 / PD/  22  / 

s:  c *jt=jt  ma-t 

9:  DA__  'i9VA33(1DD3,500) 


10: 

DA.1.  aN89D£ 

11: 

:a_L  «/T761 1 ( 21  ) 

12: 

D9  11  II  • l.MDV 

13! 

DA.L  *T761 1 ( SAME: I I ) ) 

14! 

CA.i.  -4 T 7 6 1 1 CO.) 

15! 

D*_L  «/T761 1(10) 

16: 

ID 

I c- ( MSTC< ( I I ) .32.  3) 

17: 
is:  c 

11 

C9  MT I NJE 

19: 

DA.L  ^9VA33 ( 975/  50D  ) 

20: 

DA..  A N'lSDt 

21: 

DA.L  4T761 1 ( 21 ) 

22: 

D9  21  JJ  . l.MDD 

23: 

DA.L  wT76U(IDAT(JJ)) 

24! 

DA.L  4T7&1K8) 

25: 

DA._  a)T7611I1D) 

26: 

2D 

Ic  C N5TD< ( JJ ) .32.  3) 

27: 

21 

DSsTI SJ2 

2»: 

DA.L  *' T 7 6 1 1 (PI  ) 

£9: 

DA__  a' T 7 6 1 1 ( 21) 

3o: 
31!  C 

DA.L  WT7&1 1(21) 

32: 

92TJ9M 

33: 

E'JD 

■*JT  = JT  D a T 2 


Figure  C-7.  Listing  of  subroutine  DATER. 
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Figure  C-8.  CRT  display  output  produced 
by  subroutine  DATER. 
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